home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / objcopy.1 < prev    next >
Text File  |  1995-07-25  |  18KB  |  265 lines
  1.  
  2.  
  3.  
  4.      oooobbbbjjjjccccooooppppyyyy((((1111))))        ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        oooobbbbjjjjccccooooppppyyyy((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           objcopy - copy and translate object files
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           oooobbbbjjjjccccooooppppyyyy
  14.                [----FFFF _b_f_d_n_a_m_e |||| --------ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e]
  15.                [----IIII _b_f_d_n_a_m_e |||| --------iiiinnnnppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e]
  16.                [----OOOO _b_f_d_n_a_m_e |||| --------oooouuuuttttppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e]
  17.                [----RRRR _s_e_c_t_i_o_n_n_a_m_e |||| --------rrrreeeemmmmoooovvvveeee----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e]
  18.                [----SSSS |||| --------ssssttttrrrriiiipppp----aaaallllllll] [----gggg |||| --------ssssttttrrrriiiipppp----ddddeeeebbbbuuuugggg]
  19.                [----NNNN _s_y_m_b_o_l_n_a_m_e | --strip-symbol=_s_y_m_b_o_l_n_a_m_e]
  20.                [----xxxx |||| --------ddddiiiissssccccaaaarrrrdddd----aaaallllllll] [----XXXX |||| --------ddddiiiissssccccaaaarrrrdddd----llllooooccccaaaallllssss]
  21.                [----bbbb _b_y_t_e | --------bbbbyyyytttteeee====_b_y_t_e]
  22.                [----iiii _i_n_t_e_r_l_e_a_v_e | --------iiiinnnntttteeeerrrrlllleeeeaaaavvvveeee====_i_n_t_e_r_l_e_a_v_e]
  23.                [--------ggggaaaapppp----ffffiiiillllllll====_v_a_l] [--------ppppaaaadddd----ttttoooo====_a_d_d_r_e_s_s] [--------sssseeeetttt----ssssttttaaaarrrrtttt====_v_a_l]
  24.                [--------aaaaddddjjjjuuuusssstttt----ssssttttaaaarrrrtttt====_i_n_c_r] [--------aaaaddddjjjjuuuusssstttt----vvvvmmmmaaaa====_i_n_c_r]
  25.                [--------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa====_s_e_c_t_i_o_n{=,+,-}_v_a_l]
  26.                [--------aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss] [--------nnnnoooo----aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss]
  27.                [--------sssseeeetttt----sssseeeeccccttttiiiioooonnnn----ffffllllaaaaggggssss====_s_e_c_t_i_o_n=_f_l_a_g_s]
  28.                [--------aaaadddddddd----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e=_f_i_l_e_n_a_m_e] [----vvvv |||| --------vvvveeeerrrrbbbboooosssseeee]
  29.                [----VVVV |||| --------vvvveeeerrrrssssiiiioooonnnn] [--------hhhheeeellllpppp] iiiinnnnffffiiiilllleeee [oooouuuuttttffffiiiilllleeee]
  30.  
  31.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.           The GNU oooobbbbjjjjccccooooppppyyyy utility copies the contents of an object
  33.           file to another. oooobbbbjjjjccccooooppppyyyy uses the GNU BFD Library to read
  34.           and write the object files.  It can write the destination
  35.           object file in a format different from that of the source
  36.           object file.  The exact behavior of oooobbbbjjjjccccooooppppyyyy is controlled by
  37.           command-line options.
  38.  
  39.           oooobbbbjjjjccccooooppppyyyy creates temporary files to do its translations and
  40.           deletes them afterward.  oooobbbbjjjjccccooooppppyyyy uses BFD to do all its
  41.           translation work; it knows about all the formats BFD knows
  42.           about, and thus is able to recognize most formats without
  43.           being told explicitly.
  44.  
  45.           oooobbbbjjjjccccooooppppyyyy can be used to generate S-records by using an output
  46.           target of ssssrrrreeeecccc (e.g., use ----OOOO ssssrrrreeeecccc))))....
  47.  
  48.           oooobbbbjjjjccccooooppppyyyy can be used to generate a raw binary file by using
  49.           an output target of bbbbiiiinnnnaaaarrrryyyy (e.g., use ----OOOO bbbbiiiinnnnaaaarrrryyyy)))).... When
  50.           oooobbbbjjjjccccooooppppyyyy generates a raw binary file, it will essentially
  51.           produce a memory dump of the contents of the input object
  52.           file.  All symbols and relocation information will be
  53.           discarded.  The memory dump will start at the virtual
  54.           address of the lowest section copied into the output file.
  55.  
  56.           When generating an S-record or a raw binary file, it may be
  57.           helpful to use ----SSSS to remove sections containing debugging
  58.           information.  In some cases ----RRRR will be useful to remove
  59.           sections which contain information which is not needed by
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/12/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      oooobbbbjjjjccccooooppppyyyy((((1111))))        ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        oooobbbbjjjjccccooooppppyyyy((((1111))))
  71.  
  72.  
  73.  
  74.           the binary file.
  75.  
  76.           _i_n_f_i_l_e and _o_u_t_f_i_l_e are the source and output files
  77.           respectively.  If you do not specify _o_u_t_f_i_l_e, oooobbbbjjjjccccooooppppyyyy
  78.           creates a temporary file and destructively renames the
  79.           result with the name of the input file.
  80.  
  81.  
  82.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  83.           ----IIII _b_f_d_n_a_m_e, --------iiiinnnnppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e
  84.                Consider the source file's object format to be _b_f_d_n_a_m_e,
  85.                rather than attempting to deduce it.
  86.  
  87.           ----OOOO _b_f_d_n_a_m_e, --------oooouuuuttttppppuuuutttt----ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e
  88.                Write the output file using the object format _b_f_d_n_a_m_e.
  89.  
  90.           ----FFFF _b_f_d_n_a_m_e, --------ttttaaaarrrrggggeeeetttt====_b_f_d_n_a_m_e
  91.                Use _b_f_d_n_a_m_e as the object format for both the input and
  92.                the output file; i.e.  simply transfer data from source
  93.                to destination with no translation.
  94.  
  95.           ----RRRR _s_e_c_t_i_o_n_n_a_m_e, --------rrrreeeemmmmoooovvvveeee----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e
  96.                Remove the named section from the file.  This option
  97.                may be given more than once.  Note that using this
  98.                option inappropriately may make the output file
  99.                unusable.
  100.  
  101.           ----SSSS, --------ssssttttrrrriiiipppp----aaaallllllll
  102.                Do not copy relocation and symbol information from the
  103.                source file.
  104.  
  105.           ----gggg, --------ssssttttrrrriiiipppp----ddddeeeebbbbuuuugggg
  106.                Do not copy debugging symbols from the source file.
  107.  
  108.           ----NNNN _s_y_m_b_o_l_n_a_m_e, --------ssssttttrrrriiiipppp----ssssyyyymmmmbbbboooollll====_s_y_m_b_o_l_n_a_m_e
  109.                Do not copy symbol _s_y_m_b_o_l_n_a_m_e from the source file.
  110.                This option may be given more than once, and may be
  111.                combined with other strip options.
  112.  
  113.           ----xxxx,  --------ddddiiiissssccccaaaarrrrdddd----aaaallllllll
  114.                Do not copy non-global symbols from the source file.
  115.  
  116.           ----XXXX, --------ddddiiiissssccccaaaarrrrdddd----llllooooccccaaaallllssss
  117.                Do not copy compiler-generated local symbols. (These
  118.                usually start with "L" or ".").
  119.  
  120.           ----bbbb _b_y_t_e, --------bbbbyyyytttteeee====_b_y_t_e
  121.                Keep only every _b_y_t_eth byte of the input file (header
  122.                data is not affected).  _b_y_t_e can be in the range from 0
  123.                to the interleave-1.  This option is useful for
  124.                creating files to program ROMs.  It is typically used
  125.                with an srec output target.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/12/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      oooobbbbjjjjccccooooppppyyyy((((1111))))        ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        oooobbbbjjjjccccooooppppyyyy((((1111))))
  137.  
  138.  
  139.  
  140.           ----iiii _i_n_t_e_r_l_e_a_v_e, --------iiiinnnntttteeeerrrrlllleeeeaaaavvvveeee====_i_n_t_e_r_l_e_a_v_e
  141.                Only copy one out of every _i_n_t_e_r_l_e_a_v_e bytes.  Which one
  142.                to copy is selected by the ----bbbb or --------bbbbyyyytttteeee option.  The
  143.                default is 4.  The interleave is ignored if neither ----bbbb
  144.                nor --------bbbbyyyytttteeee is given.
  145.  
  146.           --------ggggaaaapppp----ffffiiiillllllll====_v_a_l
  147.                Fill gaps between sections with _v_a_l.  This is done by
  148.                increasing the size of the section with the lower
  149.                address, and filling in the extra space created with
  150.                _v_a_l.
  151.  
  152.           --------ppppaaaadddd----ttttoooo====_a_d_d_r_e_s_s
  153.                Pad the output file up to the virtual address _a_d_d_r_e_s_s.
  154.                This is done by increasing the size of the last
  155.                section.  The extra space is filled in with the value
  156.                specified by --------ggggaaaapppp----ffffiiiillllllll (default zero).
  157.  
  158.           --------sssseeeetttt----ssssttttaaaarrrrtttt====_v_a_l
  159.                Set the start address of the new file to _v_a_l.  Not all
  160.                object file formats support setting the start address.
  161.  
  162.           --------aaaaddddjjjjuuuusssstttt----ssssttttaaaarrrrtttt====_i_n_c_r
  163.                Adjust the start address by adding _i_n_c_r.  Not all
  164.                object file formats support setting the start address.
  165.  
  166.           --------aaaaddddjjjjuuuusssstttt----vvvvmmmmaaaa====_i_n_c_r
  167.                Adjust the address of all sections, as well as the
  168.                start address, by adding _i_n_c_r.  Some object file
  169.                formats do not permit section addresses to be changed
  170.                arbitrarily.  Note that this does not relocate the
  171.                sections; if the program expects sections to be loaded
  172.                at a certain address, and this option is used to change
  173.                the sections such that they are loaded at a different
  174.                address, the program may fail.
  175.  
  176.           --------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa====_s_e_c_t_i_o_n{=,+,-}_v_a_l
  177.                Set or adjust the address of the named _s_e_c_t_i_o_n.  If =
  178.                is used, the section address is set to _v_a_l.  Otherwise,
  179.                _v_a_l is added to or subtracted from the section address.
  180.                See the comments under --------aaaaddddjjjjuuuusssstttt----vvvvmmmmaaaa, above.  If _s_e_c_t_i_o_n
  181.                does not exist in the input file, a warning will be
  182.                issued, unless --------nnnnoooo----aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss is used.
  183.  
  184.           --------aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss
  185.                If --------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa is used, and the named section
  186.                does not exist, issue a warning.  This is the default.
  187.  
  188.           --------nnnnoooo----aaaaddddjjjjuuuusssstttt----wwwwaaaarrrrnnnniiiinnnnggggssss
  189.                Do not issue a warning if --------aaaaddddjjjjuuuusssstttt----sssseeeeccccttttiiiioooonnnn----vvvvmmmmaaaa is used,
  190.                even if the named section does not exist.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/12/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      oooobbbbjjjjccccooooppppyyyy((((1111))))        ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        oooobbbbjjjjccccooooppppyyyy((((1111))))
  203.  
  204.  
  205.  
  206.           --------sssseeeetttt----sssseeeeccccttttiiiioooonnnn----ffffllllaaaaggggssss====_s_e_c_t_i_o_n=_f_l_a_g_s
  207.                Set the flags for the named section.  The _f_l_a_g_s
  208.                argument is a comma separated string of flag names.
  209.                The recognized names are _a_l_l_o_c, _l_o_a_d, _r_e_a_d_o_n_l_y, _c_o_d_e,
  210.                _d_a_t_a, and _r_o_m.  Not all flags are meaningful for all
  211.                object file formats.
  212.  
  213.           --------aaaadddddddd----sssseeeeccccttttiiiioooonnnn====_s_e_c_t_i_o_n_n_a_m_e=_f_i_l_e_n_a_m_e
  214.                Add a new section named _s_e_c_t_i_o_n_n_a_m_e while copying the
  215.                file.  The contents of the new section are taken from
  216.                the file _f_i_l_e_n_a_m_e.  The size of the section will be the
  217.                size of the file.  This option only works on file
  218.                formats which can support sections with arbitrary
  219.                names.
  220.  
  221.           ----vvvv, --------vvvveeeerrrrbbbboooosssseeee
  222.                Verbose output: list all object files modified.  In the
  223.                case of archives, "oooobbbbjjjjccccooooppppyyyy ----VVVV" lists all members of the
  224.                archive.
  225.  
  226.           ----VVVV, --------vvvveeeerrrrssssiiiioooonnnn
  227.                Show the version number of oooobbbbjjjjccccooooppppyyyy and exit.
  228.  
  229.           --------hhhheeeellllpppp
  230.                Show a summary of the options to oooobbbbjjjjccccooooppppyyyy and exit.
  231.  
  232.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  233.           `bbbbiiiinnnnuuuuttttiiiillllssss' entry in iiiinnnnffffoooo; _T_h_e _G_N_U _B_i_n_a_r_y _U_t_i_l_i_t_i_e_s, Roland
  234.           H. Pesch (June 1993).
  235.  
  236.  
  237.      CCCCOOOOPPPPYYYYIIIINNNNGGGG
  238.           Copyright (c) 1993,1994 Free Software Foundation, Inc.
  239.  
  240.           Permission is granted to make and distribute verbatim copies
  241.           of this manual provided the copyright notice and this
  242.           permission notice are preserved on all copies.
  243.  
  244.           Permission is granted to copy and distribute modified
  245.           versions of this manual under the conditions for verbatim
  246.           copying, provided that the entire resulting derived work is
  247.           distributed under the terms of a permission notice identical
  248.           to this one.
  249.  
  250.           Permission is granted to copy and distribute translations of
  251.           this manual into another language, under the above
  252.           conditions for modified versions, except that this
  253.           permission notice may be included in translations approved
  254.           by the Free Software Foundation instead of in the original
  255.           English.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 7/12/95)
  262.  
  263.  
  264.  
  265.